/*
 * Copyright 2002-2012 the original author or authors.
 *
 * Licensed under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License.
 * You may obtain a copy of the License at
 *
 *      https://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 */

package org.springframework.beans.factory.config;

import org.springframework.beans.BeanMetadataElement;

/**
 * Interface that exposes a reference to a bean name in an abstract fashion.
 * This interface does not necessarily imply a reference to an actual bean
 * instance; it just expresses a logical reference to the name of a bean.
 *
 * <p>Serves as common interface implemented by any kind of bean reference
 * holder, such as {@link RuntimeBeanReference RuntimeBeanReference} and
 * {@link RuntimeBeanNameReference RuntimeBeanNameReference}.
 *
 * @author Juergen Hoeller
 * @since 2.0
 */

/**
 BeanReference是 Spring 框架中一个用于抽象表示对 bean 名称引用的接口。
 核心特性
	 抽象引用: 以抽象方式暴露对 bean 名称的引用，不直接指向实际的 bean 实例
	 逻辑引用: 仅表达对 bean 名称的逻辑引用关系
	 通用接口: 作为各种 bean 引用持有者的公共接口
 方法
 	getBeanName(): 返回此引用指向的目标 bean 名称（永不为 null）

 设计目的
	 BeanReference 接口的主要目的是在 Spring 容器中提供一种统一的方式来处理 bean 之间的依赖关系，
 		允许以抽象的方式表示一个 bean 对另一个 bean 的引用，而不需要直接处理具体的实例。
 		这使得 Spring 能够在配置解析和依赖注入过程中更灵活地处理复杂的引用关系。
 两个主要实现类：
	 RuntimeBeanReference: 运行时 bean 引用
	 RuntimeBeanNameReference: 运行时 bean 名称引用
 */
public interface BeanReference extends BeanMetadataElement {

	/**
	 * Return the target bean name that this reference points to (never {@code null}).
	 */
	String getBeanName();

}
